Skip to content

PROD-8165 add extension development/deployment documentation#538

Open
ivbond wants to merge 1 commit into
mainfrom
feature/PROD-8165-add-ext-deployment-doc
Open

PROD-8165 add extension development/deployment documentation#538
ivbond wants to merge 1 commit into
mainfrom
feature/PROD-8165-add-ext-deployment-doc

Conversation

@ivbond

@ivbond ivbond commented Jul 6, 2026

Copy link
Copy Markdown

Description

Type of change

  • New / updated documentation page (src/content/docs/**)
  • Shared include file (src/content/_includes/**)
  • Component, layout, or styling change (src/components/**, src/styles/**)
  • Landing / use-case / case-study page (src/pages/**, src/data/**)
  • Redirects (src/data/redirects.ts)
  • Version bump / release (see release skill)
  • Build, CI, scripts, or tooling
  • Other (please describe)

Affected products

Related issues

  • Closes #

Checklist

  • pnpm check passes (Astro / TypeScript)
  • pnpm lint:eslint passes
  • pnpm lint:slugcheck passes (required if pages were added/renamed/moved across languages)
  • pnpm lint:linkcheck passes locally — required to merge; run it before requesting review (use pnpm lint:linkcheck:nobuild if you already ran a build)
  • Renamed/removed pages have a redirect in src/data/redirects.ts, and pnpm generate:redirects was run
  • No hardcoded versions — values come from src/data/versions.ts
  • Screenshots attached for visual changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new “Extensions” documentation section to the ThingsBoard docs site, including end-to-end guidance for building, deploying, and operating ThingsBoard extensions, and exposes that section in the Reference navigation.

Changes:

  • Introduces new Extensions reference pages (overview, quickstart, dev workflow, CLI deploy reference, REST deployment API) for CE/PE/Cloud variants via shared _includes.
  • Adds Extensions links to the “APIs & SDKs” reference landing include and to the generated sidebar navigation.
  • Adds new extension-related schema diagrams (light/dark variants) used by the docs.

Reviewed changes

Copilot reviewed 27 out of 41 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/content/docs/docs/reference/extensions/quickstart.mdx CE wrapper page for Extensions quickstart include
src/content/docs/docs/reference/extensions/overview.mdx CE wrapper page for Extensions overview include
src/content/docs/docs/reference/extensions/development-workflow.mdx CE wrapper page for development workflow include
src/content/docs/docs/reference/extensions/deployment-api.mdx CE wrapper page for deployment API include
src/content/docs/docs/reference/extensions/cli-deployment.mdx CE wrapper page for CLI deployment include
src/content/docs/docs/pe/reference/extensions/quickstart.mdx PE wrapper page for Extensions quickstart include
src/content/docs/docs/pe/reference/extensions/overview.mdx PE wrapper page for Extensions overview include
src/content/docs/docs/pe/reference/extensions/development-workflow.mdx PE wrapper page for development workflow include
src/content/docs/docs/pe/reference/extensions/deployment-api.mdx PE wrapper page for deployment API include
src/content/docs/docs/pe/reference/extensions/cli-deployment.mdx PE wrapper page for CLI deployment include
src/content/docs/docs/paas/reference/extensions/quickstart.mdx PaaS wrapper page for Extensions quickstart include
src/content/docs/docs/paas/reference/extensions/overview.mdx PaaS wrapper page for Extensions overview include
src/content/docs/docs/paas/reference/extensions/development-workflow.mdx PaaS wrapper page for development workflow include
src/content/docs/docs/paas/reference/extensions/deployment-api.mdx PaaS wrapper page for deployment API include
src/content/docs/docs/paas/reference/extensions/cli-deployment.mdx PaaS wrapper page for CLI deployment include
src/content/docs/docs/paas/eu/reference/extensions/quickstart.mdx PaaS EU wrapper page for Extensions quickstart include
src/content/docs/docs/paas/eu/reference/extensions/overview.mdx PaaS EU wrapper page for Extensions overview include
src/content/docs/docs/paas/eu/reference/extensions/development-workflow.mdx PaaS EU wrapper page for development workflow include
src/content/docs/docs/paas/eu/reference/extensions/deployment-api.mdx PaaS EU wrapper page for deployment API include
src/content/docs/docs/paas/eu/reference/extensions/cli-deployment.mdx PaaS EU wrapper page for CLI deployment include
src/content/_includes/docs/reference/extensions/quickstart.mdx Shared quickstart content (Java/Python tabs + CLI workflow)
src/content/_includes/docs/reference/extensions/overview.mdx Shared overview content (architecture, routing/auth, lifecycle, run modes)
src/content/_includes/docs/reference/extensions/development-workflow.mdx Shared “full loop” workflow guide content
src/content/_includes/docs/reference/extensions/deployment-api.mdx Shared REST deployment API reference content
src/content/_includes/docs/reference/extensions/cli-deployment.mdx Shared CLI deploy/reference content
src/content/_includes/docs/reference/apis-and-sdks.mdx Adds an “Extensions” card/links to the reference landing include
src/assets/schemas/extension-mode-self-hosted.svg New diagram asset used in Extensions overview (light)
src/assets/schemas/extension-mode-self-hosted-dark.svg New diagram asset used in Extensions overview (dark)
src/assets/schemas/extension-lifecycle.svg New diagram asset used in Extensions overview (light)
src/assets/schemas/extension-lifecycle-dark.svg New diagram asset used in Extensions overview (dark)
astro.sidebar.ts Adds “Extensions” group under APIs & SDKs sidebar section

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants